feat: add ralph-cli skill and replace Aider with Pi#57
Merged
Conversation
…ve ralph Add an in-repo ralph-cli agent skill (modeled on agr-cli) covering scaffold, run, RALPH.md authoring, agent selection, debugging, and the Python API, and register it in agr.toml. Replace every Aider agent suggestion across docs, examples, llms files, and the skill with Pi (pi.dev) — Pi reads piped stdin natively, so the config is just `pi -p -a` with no bash wrapper. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Two related changes:
New
ralph-cliagent skill (skills/ralph-cli/), modeled on theagr-cliskill. A top-levelSKILL.mdplus six reference files(
writing-ralphs,running,the-loop,agents,troubleshooting,python-api) that teach an agent to operate theralphCLI: scaffold,write/fix
RALPH.md, run loops, pick an agent, debug, and use the PythonAPI. Registered in
agr.tomlviaagr add ./skills/ralph-cli.Replace Aider with Pi (pi.dev) everywhere it was suggested —
README.md,docs/index.md,docs/cli.md,docs/llms.txt,docs/llms-full.txt,examples/optimize-docs/RALPH.md, and the new skill. Unlike Aider, Pi readspiped stdin natively, so the config collapses from a
bash -c '... "$(cat -)"'wrapper to just
agent: pi -p -a. Pi's invocation was verified againstpi.dev and the earendil-works/pi docs.
In the tests,
aiderwas only a generic non-Claude placeholder agent; swappedto
pi(still non-Claude/non-stream-json, behavior unchanged). The twomentions in
tasks/done/are archived history and were left intact.Verification
pytest tests/test_agent.py tests/test_console_emitter.py→ 229 passed, 1 xpassedmkdocs build --strict→ clean, zero warningsgrep -rin aider→ only intentionaltasks/done/history remainsA diary entry is included at
docs/diary/2026-06-09-ralph-cli-skill-and-pi-swap.md.Note for reviewers
The skill description's trigger terms ("ralph", "RALPH.md", "loop engineering")
are common in this repo, so the skill may activate often when working here —
worth a look if that's undesirable.
🤖 Generated with Claude Code